home *** CD-ROM | disk | FTP | other *** search
/ Belgian Amiga Club - ADF Collection / BS1 part 34.zip / BS1 part 34 / FredFish PD 308.adf / StarBlanker / src / Source.notes < prev    next >
Text File  |  1990-01-18  |  2KB  |  49 lines

  1. Source Notes for StarBlanker version 1.0
  2. ----------------------------------------
  3.  
  4.   - The Detach runtime module is not by me, nor has it been okayed for
  5.   distribution.  Therefore, it has not been included.  For those who
  6.   wish to duplicate what it does, basically it clones necessary 
  7.   structures, creates a process called "* Blanker" and does a 
  8.   CreateProc() somewhere along the way.  Minimal restructuring of the
  9.   code may be necessary to get it to work properly without the
  10.   detach module.
  11.   
  12.   - The modules may seem to be mis-named, but they really aren't.  
  13.   Blanker.MOD is a generic screen blanker module that you could use
  14.   to easily make the program do whatever you want when the screen
  15.   blanks.
  16.     For those interested in attempting this, you need to only do
  17.   the following:
  18.   
  19.     1) Create some type of Procedure with no return values and no
  20.     parameters that will be called when the screen blanks.  Make sure
  21.     that whatever this procedure is aborts and returns whenever a 
  22.     mouse move or a key press is detected.
  23.     
  24.     2) Go through Blanker.mod and substitute the name of your function
  25.     for DoStarBlank() wherever appropriate.  There is only one place
  26.     where this function gets called, and I've marked it so that 
  27.     you should be able to find it.
  28.     
  29.     That's all there is to it!  StarBlanker.MOD is *NOT* the main
  30.   module, it is simply the function that gets called when the screen
  31.   blanks.
  32.  
  33.     The StarBlanker.MOD module has a semi-generic substitution for
  34.   WritePixel() that I found to be much faster than the Intuition
  35.   equivalent.  This procedure does NOT work through layers, it writes
  36.   directly to a bitmap.  It also does not do any clipping.  
  37.   
  38.     Note also that the StarBlanker module only updates the screen
  39.   when an IntuiTicks message is received, so that it doesn't hog the
  40.   processor.  The display is much faster if things are just done in a
  41.   straight loop, but things are still pleasing at the delayed rate.
  42.  
  43.     Special thanks go to Martin Taillefer for suggesting ideas as to
  44.   how this program should work, and for providing the Detach stuff,
  45.   as well as the Workbench processing code.
  46.   
  47.   Chris Bailey
  48.   03-Jan-90
  49.